Use the GetTranslationsArray method to retrieve multiple translation candidates for multiple source texts.
The request body is of type GetTranslationsArray.
Request Body Parameters
Overview
 |
 |
Sequence
|
appId optional xs:string
A string containing "Bearer" + " " + access token.
|
|
texts optional ArrayOfstring Complex Type
A string array representing the text from an unknown language. The size of the text must not exceed 10000 characters.
|
Sequence
| |
|
from optional xs:string
A string containing the language code of the source language. Must be a valid culture name.
|
|
to optional xs:string
A string containing the language code of the target language. Must be a valid culture name.
|
|
maxTranslations optional xs:int
An int representing the maximum number of translations to return.
|
|
options optional TranslateOptions Complex Type
A TranslateOptions object which contains the values listed below. They all default to the most common settings. You do not need to set any of the values.
- Category: A string containing the category (domain) of the translation. Defaults to "general".
- ContentType: A string containing the type of content. Either "text/html" or "text/plain". Defaults to "text/plain".
- Uri: A string containing the content location of this translation.
- User: A string used to track the originator of the submission.
- State: User state to help correlate request and response. The same contents will be returned in the response.
|
Sequence
|
Category optional xs:string
A string containing the category (domain) of the translation. Defaults to "general".
|
|
ContentType optional xs:string
A string containing the type of content. Either "text/html" or "text/plain". Defaults to "text/plain".
|
|
State optional xs:string
User state to help correlate request and response. The same contents will be returned in the response.
|
|
Uri optional xs:string
A string containing the content location of this translation.
|
|
User optional xs:string
A string used to track the originator of the submission.
| | | | |
The response body is of type GetTranslationsArrayResponse.
Returns a GetTranslationsResponse array.Response Body Parameters
Overview
|
|
Sequence
|
|
Sequence
|
|
Sequence
|
From optional xs:string
If the method did not specify a From language, this will be the result of auto language detection. Otherwise it will be the given From language.
|
|
State optional xs:string
User state to help correlate request and response. Contains the same value as given in the TranslateOptions parameter.
|
|
Translations optional ArrayOfTranslationMatch Complex Type
An array of matches found, stored in TranslationMatch (see below) objects. The translations may include slight variants of the original text (fuzzy matching). The translations will be sorted: 100% matches first, fuzzy matches below.
|
Sequence
|
|
Sequence
|
Count xs:int
The number of times this translation with this rating has been selected. The value will be 0 for the automatically translated response.
|
|
Error optional xs:string
If an error has occurred for a specific input string, the error code is stored. Otherwise the field is empty.
|
|
MatchDegree xs:int
The system matches input sentences against the store, including inexact matches. MatchDegree indicates how closely the input text matches the original text found in the store. The value returned ranges from 0 to 100, where 0 is no similarity and 100 is an exact case sensitive match.
|
|
MatchedOriginalText optional xs:string
Original text that was matched for this result. Only returned if the matched original text was different than the input text. Used to return the source text of a fuzzy match. Not returned for Microsoft Translator results.
|
|
Rating xs:int
Indicates the authority of the person making the quality decision. Machine Translation results will have a rating of 5. Anonymously provided translations will generally have a rating of 1 to 4, whilst authoritatively provided translations will generally have a rating of 6 to 10.
|
| | | | | | | | | |